newBackground

Type

message

Summary

Sent to a new group right after it's created.

Syntax

newBackground

Description

Handle the newBackground message if you want to create objects or do other tasks when a new group is created.

Normally, the newBackground message is handled at a higher level of the message path, since the newly created group does not yet have a script unless the templateGroup contains one.

The actual creation is not triggered by the newBackground message, so trapping the message and not allowing it to pass does not prevent the group from being created.

A newGroup message is sent before the newBackground message. (The newBackground message is included for compatibility with HyperCard.)

Related

glossary: object, trap, message, HyperCard, message path

keyword: templateGroup

message: openBackground, newGroup, newCard

property: script

command: copy, group

control structure: pass

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile